GetSerialNoRecordsXML

SoftwareShield CheckPoint™ License Server > CheckPoint™ License Server Interfaces > CheckPoint_Webservice_References > GetSerialNoRecordsXML

## GetSerialNoRecordsXML

The GetSerialNoRecordsXML function will return multiple Serial Numbers in XML format.

###### Syntax

TCheckPointSNSerialRecordsXML * GetSerialNoRecordsXML(

long FirstSerialNoID,

long NumRecordsToReturn,

long ForLicenseID,

BSTR ASessionID

) ;

###### Parameters

FirstSerialNoID

[IN] This is a numeric value that represent the starting number of the records you wish to retrieve.

NumRecordsToReturn

[IN] This is a number represents the number of records you wish to retrieve starting from the first serial Number ID

ForLicenseID

[IN] This is a numeric value which represents the license ID of the license you wish to retrieve.

ASessionID

[IN] This is the session ID of the logged in user.

###### Remarks

The function returns a number of records starting at "FirstSerialNoID". This way a user can call the function once for each "page" of information they need to display in a client. Thus, if the need arises to display only 20 records (from ID 1000 to 1019 in a set of 5000), you don't have to retrieve all 5000 records to display those 20. (IE: a scrolling window control).

###### Return Value

Returns the custom class TCheckPointSNSerialRecordsXML. The fields of interest that is related to this method are:

- Success- returns true if the function was successful, otherwise false is returned.

- ErrorMessage- If an error occurred the associated message can be found in this field.

- SNRecordsXML- this field contains the serial number record in XML format. The following is the an example of how the format looks:

  <SN_RECORDS>

  <SN_REC SerialNo="1234-3333-3333-4444"

  CheckPointUserID="1"

  LicenseID="2"

  AuthDefIDNo="4"

  AuthParameter="0"

  TotalActivationsPermitted="123"

  OverflowActivationsPermitted="99"

  ActivationsConsumed="9">

  ...

  </SN_RECORDS>

###### Function Information

Exposed By Interface: | "ICheckPointService"
Exposed In ISAPI DLL: | "checkpoint.dll"